package com.lxr.demo.config;

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import springfox.documentation.builders.ApiInfoBuilder;
import springfox.documentation.builders.PathSelectors;
import springfox.documentation.builders.RequestHandlerSelectors;
import springfox.documentation.service.ApiInfo;
import springfox.documentation.service.Contact;
import springfox.documentation.spi.DocumentationType;
import springfox.documentation.spring.web.plugins.Docket;
import springfox.documentation.swagger2.annotations.EnableSwagger2;

@Configuration
@EnableSwagger2
public class Swagger2 {
    //默认访问地址localhost:8888/swagger-ui.html
    //美化后的UI界面：localhost:8888/doc.html

    //配置swagger2核心配置docket
    @Bean
    public Docket createRestApi(){
        return new Docket(DocumentationType.SWAGGER_2)      //制定api类型为swagger2
                .apiInfo(apiInfo())                         //定义api文档汇总信息
                .select().apis(RequestHandlerSelectors
                        .basePackage("com.lxr.demo.controller"))//指定controller所在包名
                .paths(PathSelectors.any())                 //任意contorller都提取api文档
                .build();
        }
    private ApiInfo apiInfo(){                              //定义总的说明信息
        return new ApiInfoBuilder()
                .title("电商平台接口API")                      //文档页标题
                .contact(new Contact("lxr",
                        "https://www.abc.com",
                        "abc@email.com"))              //联系人信息
                .description("为电商平台提供的api文档")          //详细说明
                .version("1.0.1")                            //文档版本号
                .termsOfServiceUrl("https://www.abc.com")    //网站地址
                .build();
    }
}
